﻿-----------------------------------------------------------------------------------
Instrukcja instalacji gry Kreatywnie w przedsiębiorczość na serwerze
-----------------------------------------------------------------------------------

1. WYMAGANIA SPRZĘTOWE (SERWER)
-----------------------------------------------------------------------------------
- Baza danych Oracle Express Edition 11g Release 2 (wskazane jest co najmniej Oracle Standard Edition One 11g).
- Dostęp do Internetu: (im szersze pasmo, tym lepszy dostęp), dla obsługiwania wielu szkół sugerowane jest symetryczne łącze internetowe o przepustowości 100Mbps lub wyższej.
- System operacyjny typu GNU/Linux z zainstalowanym serwerem Apache, PHP 5.4 (lub nowsze), sterownik Oracle dla PHP (prócz standardowych modułów Apache także moduły: pdo, gd, curl, mod_rewrite, pdo_oci, oci8 oraz oprogramowanie Oracle Instant Client for Linux). Ustawienie polskich znaków oraz odpowiedniej strefy czasowej w konfiguracji PHP oraz w systemu.
- Serwer powinien być odrębną, samodzielną jednostką. Należy unikać wydzielania obszaru na wspólnym z innymi bazami i oprogramowaniem serwerze. W szczególności, powinno unikać się stawania maszyny wirtualnej.
- W wyniku wdrażania gry w kilkunastu klasach w ramach programu pilotażowego w roku 2013/2014 stwierdzono, iż przeciętnie jeden serwer (Intel Xeon 2.66Ghz [dual core], 4GB pamięci RAM + 4GB SWAP), jest w stanie obsłużyć do 12 klas, po 32 użytkowników w każdej, przy czym plan lekcji klas był ułożony tak, iż jednocześnie zalogowani w grze byli uczniowie z maksymalnie 2 klas (ok. 60 osób grających jednocześnie). Prędkość łącza na serwerze testowym Urzędu Miasta nie jest nam znana, jednak zakładamy, iż stosując łącze symetryczne 100Mbps jak również stosując maszynę dedykowaną, a nie maszynę wirtualną (jak było w okresie testowym), oraz stosując szybszą niż Express Edition instancję Oracle powinno się udać utrzymać ilość 200 uczniów zalogowanych jednocześnie, jednak zalecamy zastosować przynajmniej 8GB RAM +4GB SWAP. Należy jednak pamiętać, że im więcej będzie zalogowanych jednocześnie użytkowników, tym wydajność serwera, a co za tym idzie jakość gry będzie spadać. Dla obsłużenia większości szkół średnich w mieście zdecydowanie należy pomyśleć nad rozłożeniem ruchu na większą ilość maszyn, gdyż jeden serwer raczej nie poradzi sobie w przypadku gdy większa ilość szkół/klas będzie odbywać zajęcia jednocześnie w tym samym czasie.
- Szczegółowa instrukcja instalacji oraz konfiguracji gry na serwerze znajduje się na płycie z grą
-----------------------------------------------------------------------------------

2. WYMAGANIA (UŻYTKOWNICY GRY)
-----------------------------------------------------------------------------------
- Dla zwykłego użytkownika Gry wystarczy w pasku adresu przeglądarki internetowej (wymagana przeglądarka Google Chrome w najnowszej wersji) wpisać uzyskany od administratora serwera adres, a następnie należy zalogować się na login i hasło podane również przez administratora, lub (w przypadku uczniów – zarejestrować nowe konto, po uruchomieniu rejestracji przez nauczyciela).
- Komputery / laptopy klienckie przeznaczone do grania powinny być wyposażone w dwurdzeniowy procesor x86-64 o częstotliwości przynajmniej 2Ghz i posiadać przynajmniej 4GB RAM. Wymagana przeglądarka internetowa: Google Chrome, w zaktualizowanej wersji.
- Instrukcja obsługi gry i Platformy Edukacyjnej znajduje się na Platformie Edukacyjnej w zakładce Strona główna / Kursy / Kursy e-learningowe / Kurs e-learningowy dla nauczycieli
-----------------------------------------------------------------------------------

3. AKTUALIZACJA
-----------------------------------------------------------------------------------
Przed przystąpieniem do instalacji należy w pierwszej kolejności sprawdzić, czy nie są dostępne aktualizacje gry w internecie.
W tym celu wchodzimy na jeden z podanych niżej linków i pobieramy najnowszą wersję gry:
Źródło podstawowe:
- http://kreatywnie.lublin.eu/pobierz/
Źródła alternatywne (mirrory):
- http://pyramidlab.pl/przedsiebiorca/pobierz/
- http://imaginalis.pl/przedsiebiorca/pobierz/
-----------------------------------------------------------------------------------
- Login i hasło do pobrania gry z powyższych lokalizacji to: login: kwp, hasło: kr34WP12e
- Jeżeli mamy już najnowszą wersję gry możemy przejść do jej instalacji.
-----------------------------------------------------------------------------------

4. INSTRUKCJA INSTALACJI NA SERWERZE:
-----------------------------------------------------------------------------------
- Instalacja Apache (oraz stworzenie vhosta)
- Instalacja Bazy Danych Oracle 11g lub nowszej.
- Instalacja PHP (najlepiej 5.4 lub nowsze) i sterownika Oracle dla PHP (moduły pdo_oci, oci8 oraz oprogramowanie Oracle Instant Client), skonfigurowanie polskich znaków w PHP.
- Instalacja innych potrzebnych modułów PHP między innymi: PDO, GD, cURL, mod_rewrite...
- Ustawienie odpowiedniej strefy czasowej w PHP oraz czasu systemowego.
- Stworzenie dwóch użytkowników/schematów w bazie Oracle (jeden dla gry, drugi dla platformy edukacyjnej).
- Skopiowanie baz danych z odpowiednich plików .sql do bazy dla gry oraz bazy dla platformy edukacyjnej.
- Skopiowanie plików gry do stworzonego vhosta, oraz plików platformy edukacyjnej do podkatalogu elearning tego vhosta.
- Gra powinna znajdować się w głównym katalogu domeny. Czyli http://gra.domena.pl, a nie http://domena.pl/gra.
- Platforma edukacyjna (Moodle) powinna znajdować się w podkatalogu /elearning/ (należy rozpakować elearning.zip)
- W katalogu nadrzędnym względem hosta należy umieścić wykorzystywany przez platformę e-learningową katalog moodledata/ i nadać mu uprawnienia zapisu
- Ustawienie namiarów na bazę danych w pliku protected/config/db.php - dla gry oraz elearning/config.php dla platformy.
- Ustawienie ścieżek do platformy edukacyjnej (ścieżek do moodle) w plikach:
--- protected/modules/administration/components/GiftWriter.php:16 const MOODLE_URL
------ (tutaj również ustawienie wersji PHP): linie 172 - 176 "THIS WORKS ON PHP 5.4 / 5.5"
--- protected/modules/administration/controllers/MainController.php (nagłówki adresów e-mail: info@kreatywnie.lublin.eu)
--- protected/modules/student/controllers/MainController.php (nagłówki adresów e-mail: info@kreatywnie.lublin.eu)
--- protected/views/layouts/main.php (link do platformy edukacyjnej)
--- src/js/moodle.js, js/vendor.js, js/vendor.min.js (link do platformy edukacyjnej)
- Stworzenie katalogów na pliki tymczasowe: /assets oraz /protected/runtime/cache z uprawnieniami do odczytu i zapisu
- Standardowe dane logowania w panelu dla pierwszego administratora to: login: admin, hasło: hasloAdmina1!
- Hasło do admina należy zmienić, a następnie stworzyć odpowiednie szkoły, klasy, dodać nauczycieli.
-----------------------------------------------------------------------------------

5. Ustawienia dla Oracle:
-----------------------------------------------------------------------------------
NLS_LANGUAGE = \'POLISH\'
NLS_TERRITORY = \'POLAND\'
NLS_NUMERIC_CHARACTERS = \'. \'
NLS_DATE_FORMAT = \'YYYY-MM-DD HH24:MI:SS\'
-----------------------------------------------------------------------------------

6. Ustawienia do php.ini:
-----------------------------------------------------------------------------------
max_file_uploads = 20
upload_max_filesize = 128MB
post_max_size = 128MB
memory_limit = 128MB
max_execution_time = 120
default_socket_timeout = 60
max_input_time = -1
-----------------------------------------------------------------------------------

-----------------------------------------------------------------------------------
2012 - 2015 (c) PyramidLab Lublin                             http://pyramidlab.pl/
-----------------------------------------------------------------------------------
